SGI Freeware 1999 August

home *** CD-ROM | disk | FTP | other *** search

/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat4 / sendq.Z / sendq

Wrap

Text File | 1999-07-16 | 27.5 KB | 527 lines

SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) NNNNAAAAMMMMEEEE sendq/q* - _H_y_l_a_F_A_X outbound job description DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN Files in the sssseeeennnnddddqqqq directory specify transmission job requests. These files are created by _h_f_a_x_d(1M), when submitting a job on behalf of _s_e_n_d_f_a_x(1) or _s_e_n_d_p_a_g_e(1). Job description files also reside in the ddddoooonnnneeeeqqqq directory; they are moved there by _f_a_x_q(1M) when a job completes. Job description files are ASCII files with lines of the form ttttaaaagggg: _v_a_l_u_e where a _t_a_g is one of the identifiers described below and a _v_a_l_u_e is either a string or number. Values start at the first non-blank character after the ``:'' and continue to the end of the line. Lines that end with a backslash character ``\'' are continued to the next line. Numeric values are decimal integers, except for cccchhhhoooopppphhhhrrrreeeesssshhhhoooolllldddd which is expressed as a floating point value. The following table lists the possible tags and the required type of the associated value. TTTTaaaagggg TTTTyyyyppppeeee DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn chopthreshold float page chopping threshold (inches) commid string communication identifier for last call company string receiver's company client string host that submitted the job cover string continuation coverpage file data string unprocessed document of indeterminate type !data string processed document of indeterminate type dataformat string data format used to transmit a facsimile desiredbr integer desired transmit speed desireddf integer desired page data format desiredec integer desired use of Error Correction Mode (ECM) desiredst integer desired minimum scanline time desiredtl integer whether or not to use ttttaaaagggglllliiiinnnneeee parameter donop string operation to perform when job is reaped external string external form of dialstring fax string document ready for transmission groupid integer _H_y_l_a_F_A_X job group identifier jobid integer _H_y_l_a_F_A_X job identifier jobtag string user-specified job identifier jobtype string job type identification string killtime integer time to give up trying to send job location string receiver's location mailaddr string email address of sender maxdials integer max number of times to dial maxtries integer max number of attempts to send job minsp integer minimum required transmit speed modem string outgoing modem to use ndials integer number of consecutive failed attempts to place call Page 1 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) notify string email notification specification npages integer number of pages transmitted ntries integer number of attempts to send current page number string dialstring to use in placing call owner string user that owns the job page string PIN in a page operation pagechop string whitespace truncation handling pagehandling string page analysis information pagelength integer facsimile page length (millimeters) pagewidth integer facsimile page width (millimeters) passwd string info to send in HDLC PWD frame pcl string unprocessed PCL document !pcl string processed PCL document poll string polling request postscript string unprocessed POSTSCRIPT document !postscript string processed POSTSCRIPT document priority integer user-specified scheduling priority receiver string receiver's identity resolution integer vertical resolution of facsimile retrytime integer time to use between job retries schedpri integer current scheduling priority sender string identity of sender signalrate string signalling rate at which a facsimile was sent state integer job scheduling state status string job status subaddr string info to send in HDLC SUB frame tagline string tagline format string tiff string unprocessed TIFF/F document !tiff string processed TIFF/F document totdials integer total number of phone calls totpages integer total pages to transmit tottries integer total number of attempts to send job tts integer time to send job useccover integer whether or not to use a continuation cover page PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS Note that all files must be owned by the fax user. Pathnames for document files must be relative to the top of the _H_y_l_a_F_A_X spooling directory and not include ``..''. cccchhhhoooopppptttthhhhrrrreeeesssshhhhoooolllldddd The minimum trailing whitespace (in inches) that must appear on a page for it to be considered for ``page chopping''. If this parameter is not specified then the value specified by the PPPPaaaaggggeeeeCCCChhhhooooppppTTTThhhhrrrreeeesssshhhhoooolllldddd configuration parameter is used; see _c_o_n_f_i_g(4F). ccccoooommmmmmmmiiiidddd The communication identifier for the last outbound call placed for this job. This string is of the form ``XXXXXXXX'' where XXXXXXXX is a decimal sequence number in the Page 2 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) range 1-99999999. cccclllliiiieeeennnntttt The fully qualified hostname for the machine from which the job was submitted. If the hostname is unknown at the time the job is submitted, then the host address in Internet standard ``.'' (dot) notation is supplied instead. ccccoooommmmppppaaaannnnyyyy The receiver's company name as specified with the ----xxxx option to _s_e_n_d_f_a_x(1). This value is used only when creating continuation cover pages. ccccoooovvvveeeerrrr The pathname of a _c_o_n_t_i_n_u_a_t_i_o_n _c_o_v_e_r _p_a_g_e to send. The file must be TIFF/F (i.e. it must already be prepared for transmission). This document will be transmitted before any other documents listed in the file. See CCCCoooonnnnttttCCCCoooovvvveeeerrrrPPPPaaaaggggeeee and CCCCoooonnnnttttCCCCoooovvvveeeerrrrCCCCmmmmdddd in _c_o_n_f_i_g(4F). ddddaaaattttaaaa The pathname of a document to send. Once a document has been processed, it is marked as !!!!ddddaaaattttaaaa so that subsequent retries do not reprocess the document. ddddaaaattttaaaaffffoooorrrrmmmmaaaatttt The format used to transmit facsimile data. This item is recorded by _f_a_x_s_e_n_d(1M) so that _n_o_t_i_f_y(1M) can return it in a notification message. ddddeeeessssiiiirrrreeeeddddbbbbrrrr The desired signalling rate to use for page data transmissions: 0 for 2400 bps, 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4 for 12000 bps, and 5 for 14400 bps (default). ddddeeeessssiiiirrrreeeeddddddddffff The desired data format to use for page data transmissions: 0 for 1-D MR, 1 for 2-D MR, 3 for 2-D MR with uncompressed data, and 4 for 2-D MMR (default). ddddeeeessssiiiirrrreeeeddddeeeecccc Whether or not to negotiate the use of Error Correction Mode (ECM): 0 to disable, 1 to enable (default). ddddeeeessssiiiirrrreeeeddddsssstttt The desired minimum scanline time to use for page data transmissions: 0 for 0 ms (default), 1 for 5 ms, 2 for 10ms/5ms, 3 for 10ms, 4 for 20ms/10ms, 5 for 20ms, 6 for 40ms/20ms, and 7 for 40ms. This value is used in selecting the negotiated session parameters. Page 3 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) ddddeeeessssiiiirrrreeeeddddttttllll Whether or not to use the format string specified by the ttttaaaagggglllliiiinnnneeee job parameter when imaging taglines on document pages. If this value is non-zero then per-job format string is used; otherwise the tagline format string specified in the server configuration file is used; see TTTTaaaaggggLLLLiiiinnnneeeeFFFFoooorrrrmmmmaaaatttt in _c_o_n_f_i_g(4F). ddddoooonnnneeeeoooopppp The treatment the job should be given when it is processed by the _f_a_x_q_c_l_e_a_n(1M) job cleaner program. The may be one of _r_e_m_o_v_e (to expunge the job description file and all associated documents that are not referenced by another job) or _a_r_c_h_i_v_e (to request that the job and associated documents be archived on the server machine). Consult _f_a_x_q_c_l_e_a_n more details on other information that may be included in this string. eeeexxxxtttteeeerrrrnnnnaaaallll The external form of the dialstring. This string is used instead of the dialstring in any status and log messages. Clients can protect private information such as access codes that must be placed in dialstrings by supplying a ``cleansed'' version of the dialstring. ffffaaaaxxxx The pathname of a TIFF/F document that is ready for transmission. If the pathname string has a leading ``xx:'', then ``xx'' is interpreted to be the index of the first directory in the file to transmit (directories are numbered starting at zero). ggggrrrroooouuuuppppiiiidddd The job group identifier, an integer number in the range 1 to 32000 assigned to each group of jobs by the _H_y_l_a_F_A_X software. Each job in a group of jobs submitted at the same time is assigned the same value by the _H_y_l_a_F_A_X software. jjjjoooobbbbiiiidddd The job identifier, a unique integer number in the range 1 to 32000 assigned to each job by the _H_y_l_a_F_A_X software. jjjjoooobbbbttttaaaagggg A user-specified string that is intended for identification purposes. If this string is defined, it is returned to the user in notification messages instead of the job identifier. kkkkiiiillllllllttttiiiimmmmeeee The time to kill this job, expressed in Page 4 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) seconds since 00:00:00 GMT, January 1, 1970. llllooooccccaaaattttiiiioooonnnn The receiver's location as specified with the ----yyyy option to _s_e_n_d_f_a_x(1). This value is used only when creating continuation cover pages. mmmmaaaaiiiillllaaaaddddddddrrrr The electronic mail address to which notification messages should be directed. mmmmaaaaxxxxddddiiiiaaaallllssss The maximum number of times the server should dial the phone. If the job cannot be completed in this number of calls, it is terminated. mmmmaaaaxxxxttttrrrriiiieeeessss The maximum number of times the server should attempt to send a job; where an attempt is defined to be a session that makes it past Phase A of the CCITT T.30 protocol (for facsimile), or similar. If the job cannot be completed in this number of tries, it is terminated. mmmmiiiinnnnsssspppp The minimum signalling rate to use for transmitting page data: 0 for 2400 bps (default), 1 for 4800 bps, 2 for 7200 bps, 3 for 9600 bps, 4 for 12000 bps, and 5 for 14400 bps. mmmmooooddddeeeemmmm The outgoing modem to use to send the job, or ``any'' if any available modem is acceptable. oooowwwwnnnneeeerrrr The identity of the user that owns the job. Typically the owner is the user that created the job, though clients with administrative privileges can change the ownership of jobs. The value is the string specified in the USER command passed to _h_f_a_x_d(1M) when a client logins in to the server. nnnnoooottttiiiiffffyyyy A specification of whether the sender wants notification: whenever the job is requeued after a failed attempt to transmit (``_w_h_e_n _r_e_q_u_e_u_e_d''), when the job is completed (``_w_h_e_n _d_o_n_e''), either of the above (``_w_h_e_n _d_o_n_e+_r_e_q_u_e_u_e_d''), or not at all (``_n_o_n_e''). nnnnppppaaaaggggeeeessss The number of pages in the facsimile, including the cover page, that have been successfully transmitted. nnnnttttrrrriiiieeeessss The number of unsucessful attempts that have been made to transmit the current page. Page 5 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) nnnnddddiiiiaaaallllssss The number of consecutive unsucessful attempts to establish carrier with the the remote device. nnnnuuuummmmbbbbeeeerrrr The dialstring to use to call the destination device. ppppaaaaggggeeee a string with PIN and to use in processing a page transmit request. ppppaaaaggggeeeecccchhhhoooopppp Whether or not to automatically truncate trailing whitespace on pages of outbound facsimile; see PPPPaaaaggggeeeeCCCChhhhoooopppp in _c_o_n_f_i_g(4F). The possible values are: ``_d_e_f_a_u_l_t'' to use the setting of the PPPPaaaaggggeeeeCCCChhhhoooopppp configuration parameter, ``_n_o_n_e'' to disable page chopping, ``_a_l_l'' to enable chopping of all pages, and ``_l_a_s_t'' to enable chopping of the last page of each document. ppppaaaaggggeeeehhhhaaaannnnddddlllliiiinnnngggg A string that contains per-page information used during facsimile transmission. Most of the information is used in the negotiation of session capabilities with optional information used in the implementation of page chopping. The string has three characters, say _x_x_c, for each page to be transmitted. The _x_x characters are a hex-encoded specification of the session capabilities required to transmit the page. The _c character is one of ``M'', ``S'', and ``P''; where: ``M'' indicates there is another page to follow and that the page requires different T.30 session parameters be negotiated (an EOM code is to be transmitted). ``S'' indicates there is another page to follow, but the page uses the same session parameters (an MPS. code is to be transmitted). ``P'' indicates this is the last page to be transmitted (an EOP code is to be transmitted). In addition, if page chopping has been enabled and the page has enough trailing whitespace to be a candidate, then each three character string will be followed by a string of the form ``_Z_X_X_X_X'', where ``XXXX'' is a 4 digit hex-encoded count of the number of bytes of data to send for a chopped page. ppppaaaaggggeeeelllleeeennnnggggtttthhhh The desired page length in millimeters. ppppaaaaggggeeeewwwwiiiiddddtttthhhh The desired page width in millimeters. Page 6 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) ppppccccllll The pathname of a PCL document to send. Once a PCL document has been processed by _f_a_x_s_e_n_d, it is marked as !!!!ppppccccllll so that subsequent retries do not reprocess the document. ppppoooollllllll The value is a Caller Identification String (CIS) to use in making a polling request. If no CIS is specified then _f_a_x_s_e_n_d will form one from the FFFFAAAAXXXXNNNNuuuummmmbbbbeeeerrrr configuration parameter. ppppoooossssttttssssccccrrrriiiipppptttt The pathname of a POSTSCRIPT document to send. Once a POSTSCRIPT document has been processed by _f_a_x_s_e_n_d, it is marked as !!!!ppppoooossssttttssssccccrrrriiiipppptttt so that subsequent retries do not reprocess the document. rrrreeeecccceeeeiiiivvvveeeerrrr The receiver's name. This value is used only when creating continuation cover pages. rrrreeeessssoooolllluuuuttttiiiioooonnnn The desired vertical resolution in lines per inch. This value should be either 98 or 196. retrytime The time, in seconds, to delay between each attempt to transmit a job that fails because of a communication-oriented problem. Normally jobs are scheduled according to a collection of configuration parameters that are tuned for the specific reason of each failure; e.g. see JJJJoooobbbbRRRReeeeqqqqPPPPrrrroooottttoooo in _c_o_n_f_i_g(4F). sssseeeennnnddddeeeerrrr The ``full name'' of the sender of the facsimile. ssssiiiiggggnnnnaaaallllrrrraaaatttteeee The signalling rate used to transmit facsimile data. This item is recorded by _f_a_x_s_e_n_d(1M) so that _n_o_t_i_f_y(1M) can return it in a notification message. ssssttttaaaatttteeee The job scheduling state. Recognized values are: 1 (_s_u_s_p_e_n_d_e_d, not being scheduled), 2 (_p_e_n_d_i_n_g, waiting for the time to send), 3 (_s_l_e_e_p_i_n_g, waiting for a scheduled timeout), 4 (_b_l_o_c_k_e_d, waiting for concurrent activity to the same destination to complete), 5 (_r_e_a_d_y, ready to be processed except for available resources), 6 (_a_c_t_i_v_e, actively being processed by _H_y_l_a_F_A_X), 7 (_d_o_n_e, processing completed). ssssttttaaaattttuuuussss Status information about the current state of the job. Typically this is the reason why the last attempt to send the facsimile failed. Page 7 (printed 6/24/99) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((MMMMaaaayyyy 11112222,,,, 1111999999996666)))) SSSSEEEENNNNDDDDQQQQ((((4444FFFF)))) ssssuuuubbbbaaaaddddddddrrrr The SubAddress information to transmit when sending a facsimile. This string should be used by the receiver to route received facsimile documents. ttttaaaagggglllliiiinnnneeee The format string to use in imaging taglines on outgoing documents. Note that this parameter is only used if the ddddeeeessssiiiirrrreeeeddddttttllll parameter is non-zero. ttttiiiiffffffff The pathname of a TIFF/F document to send. Once a TIFF document has been processed by _f_a_x_s_e_n_d, it is marked as !!!!ttttiiiiffffffff so that subsequent retries do not reprocess the document. ttttoooottttddddiiiiaaaallllssss The total number of times the server has placed a call to the receiving phone number. ttttoooottttppppaaaaggggeeeessss The total number of pages to be transmitted. ttttoooottttttttrrrriiiieeeessss The total number of attempts to transmit a job; see mmmmaaaaxxxxttttrrrriiiieeeessss above. ttttttttssss The time to send the job. If this value is non-zero, it is number of seconds since 00:00:00 GMT, January 1, 1970. Otherwise, a value of 0 is interpreted to mean process as soon as possible. uuuusssseeeeccccccccoooovvvveeeerrrr 1 if the job should use a continuation cover page during retransmission, 0 otherwise. See _h_y_l_a_f_a_x(4F) for a description of continuation cover pages. SSSSEEEEEEEE AAAALLLLSSSSOOOO _s_e_n_d_f_a_x(1), _f_a_x_q(1M), _f_a_x_q_c_l_e_a_n(1M), _f_a_x_s_e_n_d(1M), _p_a_g_e_s_e_n_d(1M), _h_f_a_x_d(1M), _c_o_n_f_i_g(4F) Page 8 (printed 6/24/99)